.. _cmlGnSetEmergencyAll:

cmlGnSetEmergencyAll
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlGnSetEmergencyAll ([in] VT_I4 BoardID, [in] VT_I4 IsDecStop , [in] VT_I4 IsEnable) 

DESCRIPTION
`````````````  

- cmlGnSetEmergency() 함수는 소프트웨어적으로 모션컨트롤러 전축을 Emergency 상태로 
  설정합니다. 비상정지(停止) 상태가 되면 모션컨트롤러는 현재 진행중인 작업을 모두 
  정지(停止 ) 합니다. 비상정지(停止)가 활성화되어 있는 동안에는 이동명령이 호출되어도 
  작업이 생략됩니다. IsDecStop 매개 변수(媒介變數)에 따라 비상 정지 혹은 감속 후 정지를 
  수행합니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 파일에서는 Boland 社의 
  Delphi나 Microsoft 社의 Visual Basic 에서는 명시적으로 이 동작이 이루어지기 때문에 
  필요하지 않습니다. 


PARAMETER
```````````````

▶ BoardID: 사용자가 설정한 디바이스(보드) ID. 
 
▶ IsDecStop : IsEnable 의 매개변수가  cmlTRUE 로  설정(設定)되면 현재 수행되고 있는 모든 
작업은 정지(停止)하게 됩니다. 이때 정지(停止)시에 급정지(停止) 할것인지 감속후 
정지(停止)할 것인지를 결정합니다. 단, IsEnable 매개 변수(媒介變數)가 cmlFALSE이면 
전체적인 비상 정지 상태를 비활성화하게 되므로, 본 매개변수의 설정 값은 무시됩니다.  

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   0 (cmlFALSE), 급정지(停止) (감속없음)  
   1 (cmlTRUE), 감속후 정지(停止) (감속도는 현재 각 축별로 설정된 감속도 적용) 

▶ IsEnable : 소프트웨어적인 비상상황제어의 활성/비활성 상태를 설정합니다.

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   0 또는 cmlFALSE, 비상상황제어 비활성 (정상 상태) 
   1 또는 cmlTRUE, 비상상황제어 활성

▶ IsDecStoped : 해당 축의 비상정지 상황시 급정지인지 감속 후 정지인지에 대한 상태값을 반환합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning
   0 또는 cmlFALSE, 급정지(停止) (감속없음) 
   1 또는 cmlTRUE, 감속후 정지(停止) (감속도는 현재 각 축별로 설정된 감속도 적용)

▶ IsEnabled : 소프트웨어적인 비상상황제어의 활성/비활성 상태를 반환합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning
   0 또는 cmlFALSE, 비상상황제어 비활성 (정상 상태) 
   1 또는 cmlTRUE, 비상상황제어 활성 

   
RETURN VALUE 
````````````````

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   음수, 수행 실패.
   ERR_NONE, 수행 성공.